home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / interinstall / ii_readme! < prev    next >
Text File  |  1995-08-25  |  15KB  |  317 lines
  1.  
  2.                    iNTERiNSTALL v1.51  07-Aug-95
  3.  
  4.               by Christopher Laprise (chrisl@ici.net)
  5.  
  6.  
  7.  
  8.  
  9.  
  10. Stuff:
  11. ------
  12.  
  13.  iNTERiNSTALL comes with no warranties expressed to implied; Use at
  14. your own risk.
  15.  
  16.  iNTERiNSTALL is Copyright © 1995 Christopher Laprise. It is freely
  17. distributable, but may not be sold for profit beyond reasonable duplication
  18. and shipping fees.
  19.  
  20.  iNTERiNSTALL is `giveware'.  Spread it, but you are encouraged to send
  21. a donation of Five US dollars (or more :-)  as 1) US money order;
  22. 2) check drawn on a US bank; 3) international money order in US funds; to
  23. this address:
  24.  
  25.            Christopher Laprise
  26.            189 Franklin St.
  27.            Fall River, MA  02720
  28.            USA
  29.  
  30.  
  31.  
  32. Intro:
  33. ------
  34.  
  35.  iNTERiNSTALL was written to address the significant problem that Amiga
  36. users face in configuring AmiTCP for internet access. Thus far, we've
  37. had a distinct disadvantage since many of the TCP/IP packages for other
  38. platforms are already geared to connect with certain Internet
  39. providers, or at least for dyanamic PPP/SLIP access where a large
  40. service assigns seemingly-random host addresses for each call. Perhaps
  41. someday the authors of Amiga Internet software will offer special
  42. install scripts for major providers.
  43.  
  44.  The iNTERiNSTALL script tries to cut out many unnecessary steps and
  45. questions for the installation of AmiTCP and PPP, the basic protocol
  46. software needed to access the Internet.
  47.  
  48.  ( v1.00 & 1.02 users-  Read these docs!  Significant changes! )
  49.  
  50.  
  51.  
  52. Requirements:
  53. -------------
  54.  
  55.  AmiTCP versions 3.0b2 or 4.0
  56.    (3.0b2 available at http://insti.physics.sunysb.edu/AMosaic/ftpdir/support
  57.     and some of the ftp sites associated with AmiNet)
  58.  
  59.  An iNTERiNSTALL module file for your Internet Provider
  60.    (Compuserve, EmpireNet, LogOnAmerica and Netcom supplied)
  61.  
  62.  PPP 1.30 by Holger Kruse (evaluation version)
  63.  
  64.  Serline 1.52 by Chris Laprise (supplied)
  65.  
  66.  Amiga OS 2.04 or greater
  67.  
  68.  
  69.  
  70. Procedure:
  71. ----------
  72.  
  73.  You must first de-archive the AmiTCP & PPP packages into the iNTERiNSTALL
  74. directory. The resulting AmiTCP and PPP sub-directories _must_ be named
  75. "AmiTCP-3.0b2" (or "AmiTCP-4.0") and "PPP" respectively.  Also put the
  76. module file for your Internet Provider in the iNTERiNSTALL directory.
  77.  
  78.  Next, run iNTERiNSTALL by clicking the icon, or from Shell by CD'ing
  79. to the iNTERiNSTALL directory and typing "execute iNTERiNSTALL".
  80.  
  81.  You will see some info, including the CPU you're using, and will be
  82. asked questions concerning data that the ppp.device needs to function.
  83. Be careful entering the device name, since device names are
  84. case-sensitive.
  85.  
  86.  If all goes well, you should be asked for a modem initialization string.
  87. A simple "ATZ" may do for you, but many modems differ in their defaults
  88. and commands. If you are in doubt and you have a high-speed modem (9600
  89. BPS or greater) then you need to supply a modem init. which does the
  90. following:
  91.            Enable RTS/CTS hardware flow control (suitable cable required)
  92.            Disable software flow control (XON/XOFF)
  93.            Enable ASB (data buffering)
  94.            Enable error correction (V.42 or MNP4)
  95.            Enable English-word result codes
  96.            Cause CD line to track actual carrier-detect state
  97.            Disable DTR hang-up mode  (Lets you resume connection after
  98.                                      a crash. Otherwise, you can leave
  99.                                      it enabled.. see notes below.)
  100.  
  101. On my modem, a Practical Peripherals PM14400FXSA, it would look like:
  102.            AT&K1&Q5Q0V1&C1&D0
  103.  
  104.  If the procedure goes smoothly, you should see the `INSTALL COMPLETE'
  105. message telling you to reboot the computer.
  106.  
  107.  
  108.  
  109. Usage:
  110. ------
  111.  
  112.  After rebooting, typing "internet" in a Shell should start the connection
  113. (the PPP script window will appear, logon, then disappear). A small window
  114. saying "StartInternet complete" will let you know when you can run your
  115. internet programs (ncftp, telnet, AMosaic, etc.). The "internet" command
  116. is just a Shell script in the S: directory that runs the
  117. amitcp:bin/startinternet script with all I/O redirected to NIL:.  It's a
  118. convenient way to start things and not have a Shell window stuck to the
  119. Workbench screen. An icon has also been included in case you like to start
  120. it from Workbench... just drag it to your favorite telecomm drawer. 
  121.  
  122.  For a quick test after connecting, try running ncftp in a Shell and then
  123. typing "OPEN ftp.compuserve.com" or other addresses like "ftp.portal.com",
  124. "ftp.wustl.edu".  Of course, Ping is always a good test.  Once you feel
  125. that AmiTCP and PPP have been installed to satisfaction, you may delete
  126. the iNTERiNSTALL directory.
  127.  
  128.  To disconnect, quit your internet programs and run stopnet. Stopnet will
  129. ask "Also attempt modem hangup?"  Answering `n'o or just hitting return
  130. will tell AmiTCP and PPP to shut down, at which point your provider should
  131. hang up for you. But if you want to make sure the modem hangs up you can
  132. answer `y'es and stopnet will send a hangup command to the modem in
  133. addition to the AmiTCP/PPP shutdown. The modem hangup option makes good
  134. sense if your modem is set to ignore DTR (which lets you Resume connection
  135. after a crash/reboot, but also means the modem won't necessarily hang up
  136. on its own when PPP shuts down).
  137.  
  138.  That's about it.... Good luck!
  139.  
  140. -Chris
  141.  
  142.  
  143.  
  144. NOTES:
  145. ------
  146.  
  147.  * The current PPP version (1.30) apparently has a buggy dialer. It may
  148.    not behave properly with certain modem init. strings or telephone #s.
  149.    For instance, when I changed the tel# to the CIS 1-800 line, the dialer
  150.    would zip through almost the entire script seemingly ignoring the WAIT
  151.    commands... it didn't even dial. Other numbers work OK for me.
  152.    Another instance is when I changed the init. from ATZ to a longer, more
  153.    explicit one (for testing) causing similar bad behavior.
  154.  
  155.  * Some programs require socket.library to work (this emulates Commodore's
  156.    unreleased TCP software).  The startinternet script checks for this
  157.    library in AMITCP:libs (not libs: !) and loads it if present.
  158.    Unfortunately, socket.library has a tendency to "disappear" from a busy
  159.    system; Even after it is loaded, it can be flushed from the system if
  160.    memory gets low and the next time you try to load a program using it,
  161.    the program will complain and exit. Not even putting socket.library in
  162.    libs: helps this (these program won't do a 'loadlib' of their own). So,
  163.    I've included an icon which will let you re-load the library.
  164.  
  165.  * Normally, you'll have to type the full AMITCP:bin/... path to use
  166.    commands like ncftp, because you'll be missing a path-assignment
  167.    (except when using 'internet' from Shell, the path will be set in
  168.    that one Shell). You may want to put a "path amitcp:bin add" command
  169.    in your s:shell-startup.
  170.  
  171.  * It is possible to *resume* a connection after a system reset (caused
  172.    by a crash perhaps) so long as your modem is set to ignore DTR (i.e.
  173.    it doesn't hangup when DTR turns off during a reset). Upon rebooting
  174.    with your modem still connected, running the Internet startup should
  175.    cause the connection to resume as if nothing happened.
  176.    This is a nice feature that can save you lots of time when dealing
  177.    with bug-ridden internet programs that keep crashing the system.
  178.    
  179.    Most modems can be set to ignore DTR with the &D0 command. If your
  180.    init. string has a &D1 or &D2 command you can replace it with &D0.
  181.    If your init. string is normally simple like ATZ (reset to defaults)
  182.    and this default doesn't ignore DTR, you can try using ATZ&D0 instead.
  183.  
  184.    You can terminate the connection with Stopnet, and your ISP _should_
  185.    hangup (stopnet also asks you if you also want to tell the modem to
  186.    hang up).  However, if you seemed to connect in the first place but
  187.    did _not_ get the Startnet Complete notice, then you should not try
  188.    simply rebooting and resuming; something is wrong with the connection
  189.    itself and the ISP's nameservers may be down.  Instead, run Stopnet
  190.    (breaking the connection completely) then retry for a fresh connection.
  191.  
  192.  * Some people have reported problems with the installation stopping
  193.    dead after the 'proceed?' prompt. Other people have had bizarre
  194.    errors regarding ENV: variables (including the ppp0.config). All I
  195.    can say to this is that it works with  A) A4000 WB3.0 with _lots_ of
  196.    enhancements;  B) A3000 WB2.04 very enhanced & using GVP IOExtender;
  197.    C & D) both systems booting plain "original" WB disks. If you have
  198.    problems similar to the above, there is likely something wrong with
  199.    your system (bad startup-sequence or some add-on utility conflicting
  200.    with the normal operation of ARexx and Shell scripts). Before sending
  201.    messages stating that you have found a so-called bug in iNTERiNSTALL,
  202.    please check whether it works booting from a copy of a _plain_ WB2.04
  203.    (or above) disk. (You can keep iNTERiNSTALL-AMITCP-PPP on the hard disk
  204.    and run it from there even though you booted from a WB floppy.)
  205.    
  206.    For the people whom the installer stops after the 'proceed?' prompt,
  207.    some have gotten it to work by running it from a Shell by cd'ing to
  208.    the iNTERiNSTALL dir and typing "rx iNTERiNSTALL.rexx system <cpu>".
  209.    For instance: "rx iNTERiNSTALL.rexx system 68000".  The problem seems
  210.    to be related to how ARexx runs in a Shell created by IconX... on a
  211.    _couple_ of people's systems (I suspect their WB has been damaged).
  212.    
  213.    Also, if you are having problems startng the connection, try starting
  214.    it in a Shell with "execute amitcp:bin/startinternet" instead of
  215.    using "internet".  This will allow you to see any error messages being
  216.    generated.
  217.  
  218.  * Why did I use AmiTCP 3.0b instead of 4.0? Personally, I don't see
  219.    any advantage to the demo version 4.0, and it can be a nuisance...
  220.    ( . . . especially with *no* documentation!!! )
  221.    Plus, once connected, 3.0b works as well and perhaps bit quicker
  222.    than 4.0 demo.  The latest "gamma" update to AMosaic called
  223.    2.0-prerelease won't run with v3, though it seems to be identical to
  224.    AMosaic 1.4b4 (this runs under v3).
  225.  
  226.  * IIMOD files can be 'built' for different Internet Providers. However,
  227.    it is currently limited to dynamic PPP links (no pre-assigned host
  228.    numbers). The current IIMOD format simply describes the
  229.    "envarc:sana2/ppp.dial" script and the "AmiTCP:db/netdb-myhost" file
  230.    containing domain names and nameservers. The #MODULE and #END lines
  231.    are necessary at the start and end of the dialer part (the rest is
  232.    netdb-myhost). The ;INSTALL lines allow the installer to ask the user
  233.    for info to be inserted into the working dial script.  The IIMOD
  234.    filenames cannot contain spaces.
  235.    
  236.  * If you need a module for your Provider, mail me with the following:
  237.  
  238.         - The real name of the provider
  239.         - Their domain name
  240.         - The IP addresses of their nameservers (2 or more are nice)
  241.         - Any logon prompts for name, password, service, host, etc.
  242.           that lead to the PPP protocol startup.
  243.           (supply the exact sequence, spelling and case!)
  244.         - US$10 fee to cover my time and costs
  245.  
  246.    Also send your email address if you'd like the module quickly sent to
  247.    you (otherwise a floppy will be sent).  The module that you get will
  248.    be designated as a beta version until I receive word from you that it
  249.    works.   (see above for my address)
  250.  
  251.  * Technical Stuff (the other stuff _wasn't_? :)
  252.    There are things you need to know about AmiTCP if you want to be a power
  253.    user.  The demo versions of AmiTCP all lack proper documentation, so
  254.    it makes your life hard not only in using it, but also in deciding if
  255.    AmiTCP can handle your needs and if it's worth paying for (IMO, NSDI,
  256.    the authors of AmiTCP, are depriving themselves of profits this way).
  257.    The NSDI people seem to assume that you _know_ AmiTCP is a port of BSD
  258.    (Berkeley) Unix networking code.  So they give you software for which
  259.    _lots_ of documentation exists, but since they do not tell you what the
  260.    software really _is_, they blockade you from learning anything about it
  261.    in a productive way. This is a major gaffe and hurts all parties
  262.    involved: the prospective user, NSDI, and the Amiga itself!  NSDI, get
  263.    a clue and at least put the following in your main 'readme' file:
  264.  
  265.       "AmiTCP is based on BSD (Berkeley) Unix networking code. Please
  266.       consult a networking guide targetted for that operating system
  267.       for the specifics on configuration and usage."
  268.  
  269.  
  270.  
  271. HISTORY:
  272. --------
  273.  
  274.    1.51 Can now install AmiTCP version 4.0 as well as 3.0b2.
  275.         Stopnet asks if it should shutdown AmiTCP (default is NO, meaning
  276.         that only the PPP connection is broken). Added icon to reload
  277.         the socket.library (AS225 emulation).
  278.  
  279.    1.50 Transformed into a modular format in which the Provider
  280.         specifics are determined by .IIMOD files. These describe the
  281.         dialer and "netdb-myhost" files. CIS and EmpireNet are included.
  282.         The CIS dialer now overrides the initial menu.
  283.         
  284.    1.11 Added additional nameserver addresses to AmiTCP config.
  285.         Stopnet checks if AmiTCP is running first (helps ensure that
  286.         PPP will be told to go offline). Installer now handles paths
  287.         containing spaces. Stopnet can attempt to tell the modem to
  288.         hang up. 'Startinternet' makes sure that the serial port is not
  289.         already in use. (The last two features required that I switch PPP
  290.         back to using shared mode.)
  291.         Version for EmpireNet released; Thanks to Thomas Barker for the
  292.         net info and testing.
  293.  
  294.    1.03 Reduced PPP SERBUF size to 4096 since the default was stressful
  295.         to some systems. Increased dialer DELAYs slightly. Added initial
  296.         DELAYs before modem init. 'Startinternet' checks to see if AmiTCP
  297.         is already running. Dialer uses '+' prefixes to help normalize
  298.         the CIS logon text (Compuserve version).
  299.  
  300.    1.02    Added a work-around for the PPP dialer bug, which seems to work,
  301.     by putting small DELAYs before each WAIT.
  302.     Added icon to stopnet. 'StartInternet' script now insures that
  303.     AmiTCP is not started up if PPP has failed to connect.
  304.  
  305.    1.01    Changed ppp.ds.cis script to use "+CIS" for Hostname, wait for
  306.     "CT" instead of "00" on modem connect, and delay 1 sec after
  307.     connect. These should work under wider range of circumstances.
  308.     Changed INSTALLCIS.rexx to ensure script bits for 'internet'
  309.     & 'stopnet'. From icon, the window is now AUTO and disappears
  310.     if the script terminates. Also configs PPP to NOT use shared
  311.     serial mode so any device conflicts are immediately suspected.
  312.     Changed 'startinternet' to mount TCP: as well as INET: for
  313.     programs like telnet.
  314.  
  315.    1.00    First release.
  316.  
  317.